home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Games Collection 1 / software vault.zip / software vault / CDR10 / MAPEDIT.ZIP / PAINT.DOC < prev    next >
Text File  |  1993-05-13  |  6KB  |  168 lines
  1.  
  2. Map editor version .7a April 1993 by Dan Kelly
  3.  
  4. This program is available free of charge, and may be freely distributed,
  5. however, if you like the program, and use it alot, please send me $20, the
  6. frequency of updates will probably be directly determined by the number of
  7. donations. also, if you can offer me a job programmin in C or assembly, I'd be
  8. interested as well.
  9.  
  10. Dan Kelly
  11. 1136 N. Mellon st, apt #1
  12. Pittsburgh, PA. 15206
  13.  
  14.  
  15. First off, this program is mostly complete, but does not represent state of the
  16. art programming. I wrote this program a few years ago when I had CGA, and was
  17. first learning to program in C. Since then I have modded it to work in VGA, and
  18. have updated the program along the way, so you will probably see code ranging
  19. from shoddy to neato, and you will probably find some redundant code...
  20.  
  21. with that out of the way, lemme tell you how to work the thing.
  22.  
  23.  
  24.                                 MAIN MAP SCREEN
  25. *******************************************************************************
  26.  
  27.  
  28. The menubar :
  29. ***********************
  30.  
  31. on the left side of the menubar, you will see up and down arrows, those arrows
  32. are used to scroll the character set up and down. the character set is located
  33. below the menubar.
  34.  
  35. the next buttons from the left, "T","B","L",and "ALL" are implemented, but not
  36. fully. what they do is allow you to assign for the current character (shown at
  37. the top of the screen) wether the player of the game will be able to move into
  38. this square from the left,right,top,bottom, or all sides, respectively. this
  39. data is stored in the file "chset.atr", and you must use dos to copy it when
  40. you wish to work with a different character set.
  41.  
  42. the next button that looks like an up/down arrow in one, moves the menubar up
  43. and down, so you can see more of the character set, or map file as you wish...
  44.  
  45. the copy button allows you to copy characters among the character set portion,
  46. from either the map or the character set to the character set.
  47.  
  48. the save button saves all files.
  49.  
  50. the exit button is self explanatory, and allows you to save also...
  51.  
  52. the edit button brings up the edit screen, and allows you to edit a character
  53. in the character set... note that you can select the character either from the
  54. map or the character set.
  55.  
  56. the "IMPORT", and "LOAD" buttons do not work at this time... I forget what I
  57. was gonna make them do hehe...
  58.  
  59. the last 4 arrows on the right allow you to move around in the map...
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Mouse buttons :
  66. *******************************
  67.  
  68. When using the arrows on the menubar, the left button actuates the arrow once,
  69. while the right button is auto-repeating, for fast movement around the
  70. map/character set.
  71.  
  72. In the Map portion of the screen, the left button will place the currently
  73. selected character on the map, and the right button will make the current
  74. character the same as the one under the cursor.
  75.  
  76. in the character set portion of the screen, either button will select the
  77. current character for editing.
  78.  
  79.  
  80.  
  81. The top status line :
  82. *************************************
  83.  
  84. X, and Y show you the position of the cursor on the map relative to the top
  85. left corner of the map (not the screen!)
  86.  
  87. VALUE shows you the numerical number of the character that the cursor is over.
  88. usefull for your game to detect certain events...
  89.  
  90. the number to the right of the status bar tells you the value of the character
  91. you have currently selected, and will place on the map when you hit the left
  92. button.
  93.  
  94. the character on the far right of the screen is the picture of the currently
  95. selected character.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                 EDITING SCREEN
  104. *******************************************************************************
  105.  
  106. Screen layout :
  107. *************************
  108.  
  109. The top left corner of the screen shows the character that you are currently
  110. editing blown up by a factor of 8.
  111.  
  112. To the right are various shots of the character, usefull for alignment.
  113.  
  114. among these is a view of the character as it sits in the character set, with
  115. surrounding characters. you can use the mouse buttons to switch among these
  116. characters for faster access.
  117.  
  118. at the bottom of the screen is the palette... by using the left, right, or
  119. middle button (if present) you can select the colors to wich button you wish.
  120. the colors are hard coded for now, but you can go into the source and change
  121. it if you wish.
  122.  
  123.  
  124. The Menubar :
  125. ************************
  126. (from left to right)
  127.  
  128. DONE:      saves changes and returns to main map screen.
  129. ABORT:     aborts changes to current character and returns to main map screen.
  130. REVERSE:   flips character from left to right.
  131. CLEAR:     clears the character to the color of the left button
  132. <,>,^,v :  shifts the character left,right,up,or down, wrapping in the process.
  133. GET COLOR: allows you to select into a button a color from the current
  134.            character, depending on wich mouse button you use.
  135.  
  136.  
  137. Editing the character:
  138. *************************
  139.  
  140. The left,right,and middle buttons apply wichever colors you have selected to
  141. them from the palette.
  142.  
  143.  
  144.  
  145.                                 DATA FILES
  146. *******************************************************************************
  147.  
  148. chset.pcx :   The sample character set file, in pcx format. you may edit this
  149.               with your favorite graphics program (Deluxe paint ][e
  150.               recommended!).
  151.  
  152. charset.dat : internal character set used to display information on the status
  153.               line.
  154.  
  155. chset.atr :   this file contains the information on wich sides of the sprite
  156.               are enterable, this file you must rename when you change
  157.               character sets if you wish to use it.
  158.  
  159. map.dat :     this file contains the map information, it is hard coded as 320
  160.               wide by 100 high, each word holds one character.
  161.  
  162. sprites.dat : this file is used internally by the map editor, and holds the
  163.               various bitmaps of the buttons, and menubars... I will be
  164.               releasing a program that will allow you to edit this shortly.
  165.  
  166.  
  167.  
  168.